Skip to content

[DOCS-13562] Add resource tag filtering sections to Azure docs#35754

Open
buraizu wants to merge 1 commit intomasterfrom
docs13562/azure-tag-filtering-section
Open

[DOCS-13562] Add resource tag filtering sections to Azure docs#35754
buraizu wants to merge 1 commit intomasterfrom
docs13562/azure-tag-filtering-section

Conversation

@buraizu
Copy link
Copy Markdown
Contributor

@buraizu buraizu commented Apr 3, 2026

What does this PR do? What is the motivation?

Fixes DOCS-13562

Adds resource tag filtering documentation to the Azure getting started guide and a reference from the automated log forwarding page. Tag filtering subsections are added under both the "Metric collection" and "Enable log collection" sections so customers can find the information regardless of which section they navigate to.

This replaces the approach in #35060, which directed customers to edit environment variables directly in the Azure portal forwarders.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

Content sourced from the Azure Doc Requests Google Doc (section 3: Azure Tag Filters).

References

@github-actions github-actions bot added the Guide Content impacting a guide label Apr 3, 2026
@buraizu buraizu added the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 3, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2026

@buraizu buraizu removed the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 10, 2026
@buraizu buraizu marked this pull request as ready for review April 10, 2026 19:05
@buraizu buraizu requested a review from a team as a code owner April 10, 2026 19:06
@rtrieu rtrieu self-assigned this Apr 10, 2026
Copy link
Copy Markdown
Contributor

@rtrieu rtrieu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor suggestions

[13]: https://learn.microsoft.com/azure/azure-monitor/essentials/diagnostic-settings
[14]: https://app.datadoghq.com/integrations/azure/add?config_azure-new-onboarding=true
[15]: https://learn.microsoft.com/azure/azure-functions/
[16]: /getting_started/integrations/azure/#resource-tag-filtering-1
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[16]: /getting_started/integrations/azure/#resource-tag-filtering-1
[16]: /getting_started/integrations/azure/#resource-tag-filtering-for-logs


{{< img src="/getting_started/integrations/azure/GSwAzure_metricExplorer.png" alt="Metric summary image" style="width:100%;" >}}

### Resource tag filtering
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Resource tag filtering
### Resource tag filtering for metrics


{{% azure-log-archiving %}}

### Resource tag filtering
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Resource tag filtering
### Resource tag filtering for logs


### Resource tag filtering

Use tag filters to control which Azure resources have their metrics collected by Datadog. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their metrics collected.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we add a line here telling users where to configure tag filters?

Suggested change
Use tag filters to control which Azure resources have their metrics collected by Datadog. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their metrics collected.
Use tag filters to control which Azure resources have their metrics collected by Datadog. Configure tag filters in the Configuration tab of the [Azure integration tile][X]. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their metrics collected.


### Resource tag filtering

Use tag filters to control which Azure resources have their logs forwarded to Datadog. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their logs forwarded.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same suggestion as above to let users know where these can be configured

Suggested change
Use tag filters to control which Azure resources have their logs forwarded to Datadog. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their logs forwarded.
Use tag filters to control which Azure resources have their logs forwarded to Datadog. Configure tag filters in the Configuration tab of the [Azure integration tile][X]. A tag filter is a comma-separated list of tags in the form `key:value`. Only resources that match at least one tag in the filter have their logs forwarded.

For example: `datadog:monitored,env:production,!plan_tier:basic,instance-type:c1.*`

This filter forwards logs from resources tagged with `datadog:monitored` or `env:production`, excludes resources tagged with `plan_tier:basic`, and includes resources with an `instance-type` tag matching `c1.*`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If no tag filter is set, Datadog collects metrics from all Azure resources.

For example: `datadog:monitored,env:production,!plan_tier:basic,instance-type:c1.*`

This filter collects metrics from resources tagged with `datadog:monitored` or `env:production`, excludes resources tagged with `plan_tier:basic`, and includes resources with an `instance-type` tag matching `c1.*`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If no tag filter is set, Datadog collects metrics from all Azure resources.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants